发起一次赠送请求时需要创建一个新的 balance_bonus 对象。
| 请求参数 | 描述 | 
|---|---|
| APP_ID required string | 对应 app对象的id,该参数仅需要填写在请求地址内,查看 如何获取App ID。 | 
| amount required int | 受赠金额,单位为分。 | 
| user required string | 受赠的 user对象的id。 | 
| order_no required string | 商户订单号,必须在商户的系统内唯一,64 位以内。 | 
| description optional string | 附加说明,最多 60 个 Unicode 字符。 | 
| metadata optional hash | 详见 元数据。 | 
返回
返回一个 balance_bonus 对象,或者一个错误,详见 错误。
POST https://api.pingxx.com/v1/apps/{APP_ID}/balance_bonuses待补充
待补充
待补充
待补充
待补充
待补充
待补充
curl https://api.pingxx.com/v1/apps/app_1Gqj58ynP0mHeX1q/balance_bonuses \
-H "Pingplusplus-Signature: {SIGNATURE}" \
-H "Pingplusplus-Request-Timestamp: 1496728534" \
-u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC: \
-d {
	"amount": 1000,
	"user": "test_user_001",
	"order_no": "2017071110258972"
	"description": "余额赠送描述"
}待补充
待补充
待补充
待补充
待补充
待补充
待补充
{
  "id": "311317071315160600000100",
  "object": "balance_bonus",
  "app": "app_1Gqj58ynP0mHeX1q",
  "created": 1496728534,
  "livemode": false,
  "paid": true,
  "refunded": false,
  "amount": 100,
  "amount_refunded": 0,
  "time_paid": 1496728594,
  "user": "user_007",
  "order_no": "2017071110258972",
  "balance_transaction": "310317060612081500000501",
  "description": "余额赠送",
  "metadata": {}
}